.. _ecos_select_component:

Ecos Select
===========

.. contents::
   :depth: 4
   

Компонент "выбор из списка". 

Основан на стандартном formio-компоненте **Select**, был модифицирован, чтобы список возможных значений формировался автоматически.

Если тип атрибута - перечисляемое значение. Например, статус, который задается в типе. Для этого нужно во вкладке :guilabel:`Данные` выставить полю **Тип источника данных** значение URL, а в поле **URL-адрес источника данных** указать значение **/citeck/ecos/records/query**.

 .. image:: _static/ecos_select/ecos_select_1.png
       :width: 500
       :align: center

Достаточно на вкладке API прописать атрибут как показано выше. 

Значение в режиме просмотра
----------------------------

В компоненте список представляется как набор объектов со свойствами ``value & label``. 

Есть два режима представления значения на карточке:

  * **текст**;
  * **ссылка (по умолчанию)**

На отображение влияют:

  * флаг **Отобразить выбранное значение в виде текста. Значение по умолчанию — ссылка/Display selected value as a text. Default value is link**;
  * формирование списка элементов

Если флаг установлен - текст. 

Если задано значение ``recordRef`` (это может быть актуально когда ``value`` отлично от ``recordRef`` для формирования ссылки), то оно представляется в виде ссылки. 

Если параметры не подходят - текст.

Примеры заполнения для типа источника Custom
---------------------------------------------

Данные берутся из Async Data с типом **Records Query**:

.. list-table::
      :widths: 20 20
      :align: center

      * - |

          .. image:: _static/ecos_select/Records_Query_01.png
                :width: 600
                :align: center

        - |

            .. image:: _static/ecos_select/Records_Query_02.png
                  :width: 500
                  :align: center

Данные берутся из Async Data с типом **Records Array**:

.. list-table::
      :widths: 20 20
      :align: center

      * - |

            .. image:: _static/ecos_select/Records_Array_01.png
                  :width: 600
                  :align: center

        - |

            .. image:: _static/ecos_select/Records_Array_02.png
                  :width: 500
                  :align: center